home *** CD-ROM | disk | FTP | other *** search
/ Megahits 5 / Megahits 5 (1994)(GTI - Rhein-Main-Soft)(DE)(Disc 2 of 2)[!].iso / archive / print / hwgpostbeta2.lha / HWGPOST / README.FIRST < prev    next >
Text File  |  1994-06-05  |  10KB  |  253 lines
  1.  
  2. Users of HWGPOST beta 1, please note: This text has changed in some places.
  3. Please read it again.
  4.  
  5. What is this?
  6. =============
  7.  
  8. What you get here is the second version of HWGPOST that is publically
  9. available. It is _extremely_ raw, very incomplete, and probably buggy as
  10. hell. My intention is to abuse you as beta tester. ;^)
  11.  
  12. HWGPOST is project that I started because I had some problems with
  13. post.library 1.7 (and 1.86 where post.library stayed the same) not handling
  14. some PostScript code correctly. So I built on the post 1.7 source. HWGPOST
  15. is IMHO a major step towards PostScript Level 2 already and as time and
  16. motivation permits it will hopefully become a R&W book compliant PostScript
  17. Level 2 interpreter library with maybe some Display PostScript extensions.
  18.  
  19. Currently this archive is probably mostly useful to users of post.library
  20. up to 1.7.
  21.  
  22. Major new features for HWGPOST beta 2
  23. =====================================
  24.  
  25.     - Halftone dicts should work as expected now.
  26.     - Patterns should work though the cache space is limited to 60K as we
  27.       don't have setsystemparams yet. (3 pattern examples included)
  28.     - Read the History file for more info.
  29.     - band rendering operators renamed with compatibility kludge in init.ps
  30.  
  31. Requirements & Compatibility
  32. ============================
  33.  
  34. OS:      >=V37 (= KS2.04)
  35.  
  36. Memory: As much as possible. HWGPOST tends to need noticeable more memory
  37.         than post.library 1.7 for complex PostScript files. You should have
  38.         at least 2MB to have fun with it.
  39.  
  40. HD:     Suggested
  41.  
  42. HWGPOST should be compatible to all applications using post.library 1.7
  43. with the exception of the "callextfunc" and some other special non standard
  44. operators, e.g. I have found no problems with PostView.
  45.  
  46.  
  47. Legal stuff/Distribution/bla
  48. ============================
  49.  
  50. I need to explain somethig first. I built on the post 1.7 sources by Adrian
  51. Aylward. He did an amazing job with post up to and including 1.7.  I do not
  52. claim to having put it all together myself from the the very first byte.
  53. But I have thrown out or reworked almost every single line of it and there
  54. is not much left that is truly unchanged. Adrian Aylward set up many useful
  55. concepts. I reworked most of them for going towards PostScript Level 2.
  56.  
  57. While it may not look so from the outside HWGPOST is a major step away from
  58. its origins, and so I claim the right to have something new here. Note that I
  59. did not take over any code from other sources than post 1.7 except for
  60. some fixes to post 1.7 that people sent me (Thanks especially to Tom
  61. Rokicki for his fixes and other unrelated things). No GNU code, no IBM
  62. code, nor anything else. To be honest I tried to look at some ghostscript
  63. code once for a particular feature, but I found it so ugly that I threw it
  64. out faster than you can say "out" (I never even found the code for the
  65. feature I was looking for). This means, that all that you read in the
  66. history file is only my work.
  67.  
  68. Because of all the above, there will be different rules on HWGPOST that
  69. start out right _now_ even with this beta version:
  70.  
  71.     - Unlike with post 1.7, I am restricting commercial use somewhat:
  72.  
  73.           For use in commercial products or claims of compatibilty to
  74.           HWGPOST to enhance the value of a commercial product, you need to
  75.           contact me first to work something out.
  76.  
  77.           (Except for Tom Rokicki. He may use HWGPOST whenever he finds it
  78.            acceptable for AmigaTeX)
  79.  
  80.     - If you are just a user of HWGPOST, consider it as Giftware. I like
  81.       money, too, but it doesn't have to be money. Anything nice will do.
  82.       Books, Networking boards, Ax000s, HDs, SW, non technical things,
  83.       whatever. If you intend to use post and forget about me
  84.       intentionally, don't expect too much support.
  85.  
  86.     - If you want to use HWGPOST commercially (e.g. to make money by using
  87.       it in your office), I feel that you should consider this very fact
  88.       when thinking about a gift. If you think HWGPOST to be good enough to
  89.       support you making a living, you should value it as such.
  90.  
  91.     - Starting with HWGPOST beta 2 (this release), any user of HWGPOST is
  92.       required to register with me via email or smail.
  93.  
  94. All (important) rights reserved, so to speak. This is currently a private
  95. undertaking for fun, but I have not yet lost hope that there is maybe some
  96. reward in it for me, too. :-)
  97.  
  98. If you don't like the above, I don't want you to use HWGPOST. You should
  99. live with post 1.7 or something else then.
  100.  
  101.  
  102. Why this beta?
  103. ==============
  104.  
  105. A lot of stuff is in place within HWGPOST already even though it is
  106. probably still far from completion. Actually it is so much that I hope to
  107. find bugs with your help now. I do not have test cases and PostScript files
  108. anymore to test all that PostScript Level 2. You will read some "untested"
  109. comments in the history file. I have checked for basic functionality with
  110. all my changes, but nobody knows where the bugs hide yet. So I am asking
  111. you for bug reports to make HWGPOST get better.
  112.  
  113. I am interested in:
  114.  
  115.     - Enforcer hits, mungwall problems, reproducable crashes
  116.     - deviation of behaviour compared to Adobe Level 2 products
  117.     - Short and precise PostScript example files that break with HWGPOST
  118.  
  119. and I need your complete computer and OS configuration with any bug report
  120. including any non C= WB things that you run like
  121. MagicMenu/ReqTools/CpuBlit.
  122.  
  123. I am also interested in a short note if you have files using specific
  124. Level 2 features available with HWGPOST that _don't_ break.
  125.  
  126. Thank you for your help!
  127.  
  128. Oh well, if you are one of those using pirated [KS/WB] SW, don't bother
  129. asking for help. I won't help you and I don't want you to use HWGPOST
  130. either in this case.
  131.  
  132.  
  133. What should a bug report look like?
  134. ===================================
  135.  
  136. I prefer bug reports created with the C= 'report' tool. Any bug report
  137. _must_ contain step by step instructions to reproduce the bug on a standard
  138. WB setup. Telling me "You need to install this pack of special OS hacks to
  139. make the bug appear" usually leads to no result. If it is a bug related to
  140. a PostScript program, I'd need a short example program to reproduce it. If
  141. the bug is dependant on the exact layout of the program (e.g. with eexec
  142. problems), you should thinking about using lha and uuencode to preserve any
  143. spaces, tabs, newlines, or other special characters in the file that might
  144. otherwise be lost in email.
  145.  
  146. _AN_ABSOLUTE_MUST_ is the output of C:VERSION FULL (or a version comment in
  147. the file or printed in a window if C:VERSION does not yield useful
  148. results) _and_ C:LIST for any program involved. This includes but is not
  149. limited to:
  150.  
  151.     - The OS (Use ShowConfig)
  152.     - The frontend (post, postband, postview, etc)
  153.     - The library post.library
  154.     - The support files init.ps, HWGPOSTResources
  155.     - For printing, the printer driver
  156.  
  157.  
  158.  
  159. What is included?
  160. =================
  161.  
  162.     - README.FIRST      (This file)
  163.  
  164.     - post.library      (Using C= IEEE libs for all Amigas)
  165.  
  166.     - post.library.20   (Compiled for >=68020 using inline coprocessor math)
  167.  
  168.     - History           (Informal overview on the changes since post 1.7)
  169.  
  170.     - init.ps           (A new init.ps. You _will_ need to use it)
  171.  
  172.     - HWGPOSTResources  (Example declaration of available external
  173.                          resources, e.g. fonts. Referenced by init.ps)
  174.  
  175.     - postlib.h         (The include file with some infos on how to use
  176.                          the 24 bit color features of HWGPOST)
  177.  
  178.     - post              (A hacked up post 1.7 frontend to try out HWGPOST.
  179.                          Nothing fancy.)
  180.  
  181.  
  182. Don't ask me for my sources. Currently I have no plans whatsoever to
  183. release them in full or part to anyone. After reading through the History
  184. you might understand why.
  185.  
  186.  
  187. Special note on the 'post' frontend
  188. ===================================
  189.  
  190. The included 'post' frontend is a major hackup of the original (ugly)
  191. source to suit my testing needs. It may or may not do what you expect and
  192. it might or might not be compatible to the original 'post'. Anything can
  193. happen. If you don't get the output you expect, please send me a detailed
  194. bug report and fall back on PostView or the old 'post' frontend for now.
  195.  
  196.  
  197. Installation
  198. ============
  199.  
  200. 1. Save your existing post.library, init.ps, and post. HWGPOST might break your
  201.    setup and I don't want you to be out in the cold.
  202.  
  203. 2. I am sure you have the POST: and PSFONTS: assigns that are needed for post 1.7.
  204.    If not. Create them, and put all your type 1 fonts into PSFONTS:
  205.  
  206. 3. Put init.ps, HWGPOSTResources, and (if you want to) post into POST:
  207.  
  208. 3.1 Edit HWGPOSTResources for _your_ font setup in PSFONTS: You'll probably
  209.     need to throw out and add some lines.
  210.  
  211. 4. Copy your choice of post.library[.020] into LIBS:
  212.  
  213. 5. Shut down any running applications using post.library and do an "avail
  214.    flush".
  215.  
  216. 6. Try HWGPOST and send me detailed bug reports with reproducable examples!
  217.  
  218.  
  219. My TODO list
  220. ============
  221.  
  222. Well, lots of stuff as time permits:
  223.  
  224.     - Composite Fonts (Anybody got a clean one for me as test case?)
  225.     - Rework of disk resource handling
  226.     - Finish up Binary Object Sequences
  227.     - User path operators
  228.     - Forms
  229.     - missing filters
  230.     - missing image functionality
  231.     - device parameters
  232.     - insideness operators
  233.     - missing color spaces
  234.     - rest of the Level 2 graphics stuff
  235.     - VM garbage collection
  236.     - whatever else is needed for a languagelevel of 2
  237.  
  238.  
  239. My Address
  240. ==========
  241.  
  242.  *  Heinz Wrobel
  243.  *  Karlstr. 16
  244.  *  82131 Gauting
  245.  *  Germany
  246.  *  FAX +49 89 850 51 25 (I don't like phone calls)
  247.  *  <heinz@hwg.muc.de>
  248.  
  249. Have fun!
  250.  
  251. Heinz Wrobel
  252.  
  253.